home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / midi / mdInit.z / mdInit
Encoding:
Text File  |  1998-10-20  |  4.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. mmmmddddIIIInnnniiiitttt((((3333ddddmmmm))))                                                        mmmmddddIIIInnnniiiitttt((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mdInit, mdRegister, mdUnRegister  - initialize MIDI system and register
  10.      new interfaces
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////mmmmiiiiddddiiii....hhhh>>>>
  14.  
  15.      iiiinnnntttt mmmmddddIIIInnnniiiitttt((((vvvvooooiiiidddd))));;;;
  16.      cccchhhhaaaarrrr ****mmmmddddRRRReeeeggggiiiisssstttteeeerrrr((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****nnnnaaaammmmeeee))));;;;
  17.      iiiinnnntttt mmmmddddUUUUnnnnRRRReeeeggggiiiisssstttteeeerrrr((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****nnnnaaaammmmeeee))));;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      mmmmddddIIIInnnniiiitttt initializes the MIDI library and returns the current number of
  21.      configured MIDI interfaces.  mdInit must be called before the application
  22.      calls any other MIDI library routines.  mdInit returns 0 if no interfaces
  23.      are configured.
  24.  
  25.      An application may call mmmmddddIIIInnnniiiitttt multiple times to update the MIDI
  26.      library's internal list of available ports.  Any interfaces configured
  27.      after the initial call to mdInit will be inaccessible by the application
  28.      until mdInit is called again; long-running applications which maintain a
  29.      list of active devices should call mdInit periodically to insure that
  30.      their device list is up-to-date.  Calling mdInit multiple times has no
  31.      effect on previously opened ports.
  32.  
  33.      mmmmddddRRRReeeeggggiiiisssstttteeeerrrr creates a new internal MIDI interface named _n_a_m_e.  If an
  34.      interface with the requested name is already configured, mdRegister will
  35.      generate a new unique name for the port and return the unique name (this
  36.      is done by appending a digit onto the end of the name). mdRegister
  37.      returns the name of the device or _N_U_L_L in event of an error.
  38.  
  39.      mmmmddddUUUUnnnnRRRReeeeggggiiiisssstttteeeerrrr removes the internal MIDI interface indicated by _n_a_m_e.
  40.      mdUnRegister returns 0 if the interface is successfully removed.  If an
  41.      error occurs, -1 will be returned instead.  Internal interfaces must be
  42.      explicitly unregistered when an application is finished with them; they
  43.      are a limited resource and are not released when the application which
  44.      originally created them exits.
  45.  
  46.  
  47. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  48.      mdInit returns the number of valid devices on the system or -1 on
  49.      failure.
  50.  
  51.      mdRegister returns the name used for the new interface; if the
  52.      registration fails, NULL is returned.  The storage for the returned name
  53.      is allocated by malloc.  The caller should call free() when it is done
  54.      with the name.
  55.  
  56.      mdUnRegister returns 0 on success; if it fails, it returns -1.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmddddIIIInnnniiiitttt((((3333ddddmmmm))))                                                        mmmmddddIIIInnnniiiitttt((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      mmmmddddIIIInnnnttttrrrroooo((((3333ddddmmmm))))
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.